package com.ruoyi.common.base.user.mapper;


import com.ruoyi.common.base.user.domain.User;
import com.ruoyi.common.base.user.dto.UserInviteListCondition;
import com.ruoyi.common.base.user.vo.UserInviteAppVO;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * 用户Mapper接口
 *
 * @author gdk
 * @date 2023-05-15
 */
public interface UserMapper {
    /**
     * 查询用户
     *
     * @param id 用户主键
     * @return 用户
     */
    public User selectUserById(Long id);

    /**
     * 查询用户列表
     *
     * @param user 用户
     * @return 用户集合
     */
    public List<User> selectUserList(User user);

    /**
     * 新增用户
     *
     * @param user 用户
     * @return 结果
     */
    public int insertUser(User user);

    /**
     * 修改用户
     *
     * @param user 用户
     * @return 结果
     */
    public int updateUser(User user);

    /**
     * 删除用户
     *
     * @param id 用户主键
     * @return 结果
     */
    public int deleteUserById(Long id);

    /**
     * 批量删除用户
     *
     * @param ids 需要删除的数据主键集合
     * @return 结果
     */
    public int deleteUserByIds(Long[] ids);

    /**
     * 登录时，根据openId查询用户
     *
     * @param openId openId
     * @return {@link User}
     * @author gdk
     * @since 2023/5/22 21:26
     */
    User getUserByOpenId(String openId);

    /**
     * 设置邀请人ID
     *
     * @param id            当前用户id
     * @param inviteId      邀请人ID
     * @param tier2InviteId 间接邀请人ID
     * @return {@link int}
     * @author gdk
     * @since 2023/5/26 22:02
     */
    int setInviteId(@Param("id") Long id,
                    @Param("inviteId") Long inviteId,
                    @Param("tier2InviteId") Long tier2InviteId);

    /**
     * 设置下级的间接邀请人ID
     *
     * @param id       id
     * @param inviteId 邀请人ID
     * @author gdk
     * @since 2023/5/31 18:37
     */
    int setSubTier2InviteId(@Param("id") Long id,
                            @Param("inviteId") Long inviteId);

    /**
     * 查询下级
     *
     * @param condition 条件
     * @return {@link List<  UserInviteAppVO >}
     * @author gdk
     * @since 2023/5/27 14:56
     */
    List<UserInviteAppVO> appInviteList(UserInviteListCondition condition);

    /**
     * 查询并锁定
     *
     * @param condition 条件
     * @return {@link User}
     * @author gdk
     * @since 2023/5/27 21:03
     */
    User getOneLock(User condition);

    /**
     * 获取可用的用户信息
     *
     * @param inviteId 上级id
     * @return {@link User}
     * @author gdk
     * @since 2023/5/31 17:24
     */
    User getAvailableUser(Long inviteId);
}
